home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / misc / gnu_emacs / em1934i3.readme < prev    next >
Text File  |  1999-04-19  |  14KB  |  318 lines
  1. Short:    GNU Emacs-19.34 V2.10 ELisp sources
  2. Uploader: bertw@knuut.de (Bert Winkelmann)
  3. Author:   Patched by bertw@knuut.de (Bert Winkelmann)
  4. Type:     util/gnu
  5. Requires: OS-v39 (for GUI), 8MB RAM, 68ec20, IxEmul library
  6. Version:  AmigaOS patchlevel 2.10
  7.  
  8. This distribution holds version 19.34 of GNU Emacs, the extensible,
  9. customizable, self-documenting real-time display editor.
  10.  
  11.  {Sorry about my bad English.}
  12.  
  13. This Amiga port, like most IxEmul ports, is probably more close to its
  14. baseline version than previous ports. Despite of this, it haves also
  15. some of the Amiga features (ARexx, AppWindow, ASL).  The Intuition
  16. based GUI is very similar to the X GUI.  You should be able to use all
  17. GUI based Lisp applications without making any adaptions.
  18.  
  19. Normally you may want to use this program with Intuition, but you can
  20. also use it on terminals via AUX:.  It's also possible to run it on X,
  21. but you need a different configured programfile version for that.
  22.  
  23. Amiga related Features
  24. ======================
  25.  
  26.    AREXX port (not in X nor TTY-only versions)
  27.    
  28.    Intuition-GUI: multiple colors and font styles * multiple frames
  29.    (Intuition windows) on one or more public screens (and invisible
  30.    frames too) * vertical scroll bars * pens are not really obtained from
  31.    system until first use in drawing. * Workbench iconify and drag'n'drop
  32.    * clipboard support * pop-up menu (configurable, scroll-able, full
  33.    keyboard control) * ASL file+font requester (used by "Amiga" menu) *
  34.    provides most of old "amiga-" LISP-functions for compatibility with
  35.    formerly Emacs-18 AmigaOS port (e.g. amiga-set-geometry) * 2 different
  36.    modes for numeric keypad (NumLock) * provides Meta, Super and Hyper
  37.    modifier keys
  38.    
  39.    Console: amiga-set-font implements font changing on CON:
  40.    
  41.    TTY: you can open a sub shell if your shell implements no job-control.
  42.  
  43. Version Numbers
  44. ===============
  45.  
  46. There are two version numbers.  One ist the baseline version number
  47. (19.34).  Note that the diff archives contains currently patches for
  48. two different baseline versions (19.34 and 20.3).
  49.  
  50. The other number specifies the version of my patches (like V2.10).
  51. The current version is V2.10.  The version for the binary main archive
  52. may be different (like V2.9).  It will be updated automatically if you
  53. install any of the program archive on top it (they contain not only
  54. the program files but also some updates to the main archive too (delta
  55. update)).
  56.  
  57.  
  58. Parts of this Distribution
  59. ==========================
  60.  
  61. There exists both a source and binary distribution.
  62.  
  63. Source Code
  64. -----------
  65.  
  66. The source distribution comes in two different forms: a small diff
  67. archive and a big complete archive.
  68.  
  69.   ------------------  ----------------------------------------
  70.   em1934dif.lha       - GNU Emacs 19.34 V2.10 diffs
  71.   em1934src.lha       - GNU Emacs 19.34 V2.10 source
  72.   ------------------  ----------------------------------------
  73.  
  74. Note: The LhA archives may contain "tar.gz" or even "tar.bz2"
  75. archives.  You will need a "tar" unarchiver (tar/untar) and the
  76. correct decompression program (gzip for .gz; bzip2 for .bz2).  I will
  77. limit the use of bzip2 to the really big (and rather uninteresting)
  78. source archive.
  79.  
  80. Note: If you want to compile Emacs yourself and having acces to the
  81. original baseline sources, you need only the diffs archive.  All you
  82. have to do ist invoking "sh install.sh 19.34 src/emacs-19.34" to patch
  83. the source. It's tested.
  84.  
  85. Binaries
  86. --------
  87.  
  88. The binary distribution consist of a single main archive and some
  89. Emacs program files (in different flavors).  Note: The installation
  90. should go into the "gg:" directory.  This could be a multi-assign too.
  91. Emacs depends on this.  Please read the README* file in the program
  92. archive to learn how to make the dumpfile (it's very easy now).
  93.  
  94. Note: Install the main archive *before* the program archive.
  95. Otherwise the newer files in the program archive will be overwritten
  96. by older versions from the main archive.
  97.                     
  98.   ------------------  ----------------------------------------
  99.   em1934bin.lha      - GNU Emacs 19.34 V2.10 installed in gg: 
  100.  
  101.   em1934i0.lha       - GNU Emacs 19.34 V2.10 Intuition 28bit 
  102.   em1934i1.lha       - GNU Emacs 19.34 V2.10 Intuit. 28bit-seg
  103.   em1934i3.lha       - GNU Emacs 19.34 V2.10 Intuition 32bit
  104.   ------------------  ----------------------------------------
  105.  
  106. Optional Archives:
  107.  
  108.  Program Files
  109.   ------------------  ----------------------------------------
  110.   em1934x0.lha        - GNU Emacs 19.34 V2.10 X 28bit 
  111.   em1934x1.lha        - GNU Emacs 19.34 V2.10 X 28bit-seg
  112.   em1934x3.lha        - GNU Emacs 19.34 V2.10 X 32bit
  113.   em1934t0.lha        - GNU Emacs 19.34 V2.10 CON/AUX 28bit 
  114.   em1934t1.lhaa       - GNU Emacs 19.34 V2.10 CON/AUX 28bit-seg
  115.   em1934t3.lha        - GNU Emacs 19.34 V2.10 CON/AUX 32bit
  116.   ------------------  ----------------------------------------
  117.  
  118.  ELisp Source Files Missing in em1934bin.lha (needed for debugging
  119.  and educational purposes only)
  120.  
  121.   ------------------  ----------------------------------------
  122.   em1934els.lha      - GNU Emacs 19.34 V2.10 ELisp sources
  123.   ------------------  ----------------------------------------
  124.  
  125. What does 28, 28s and 32 bit mean?
  126. ----------------------------------
  127.  
  128. If your machine does not have RAM above 28bit, then everything is
  129. fine.  Just use the "28bit" version, which is faster than the others:
  130.  
  131. normal/28  - RAM inside 28bit address range is usable
  132.          runs on machines having only RAM upto 0x0fffffff
  133.          (use ShowConfig to learn about this)
  134.  
  135. If your machine has RAM above 28bit you have to use one of the
  136. following flavors which implements segmented RAM. Note: 28s is much
  137. faster than 32.
  138.  
  139. seg1/28s   - RAM inside one 28bit segment is usable (DATA_SEG_BITS feature)
  140.              runs on machines with FastMem above 28bit
  141.          RAM in range 0xZ0000000..0xZfffffff (i.e. the high nibble (Z)
  142.               must be the same for all usable RAM))
  143.  
  144. seg3/32    - RAM inside 8 independent 25bit segments usable
  145.              runs on machines with both FastMem above and below 28bit.
  146.          (allows using of mixed RAM not being in a common
  147.               28bit block (i.e. with a different high nibble))
  148.  
  149.  
  150. Here comes additional info taken from my WWW page.
  151. ===========================================================================
  152.    
  153.    DESCRIPTION
  154.    
  155.    This project is about running GNU Emacs 19+20 on AmigaOS using the
  156.    IxEmul library and GCC. It supports both the native AmigaOS window
  157.    system "Intuiton" (>=V39) and X (and of course plain terminals too).
  158.    
  159.    The Intuition GUI implements almost all features of the X GUI except
  160.    16bit fonts. You will also get Drag'n'Drop and an ARexx port.
  161.    
  162.    I have tried to make it so compatible as possbile to prevent you and
  163.    me from changing any LISP packages. You should never have to change
  164.    path syntax, font names, window system names. On the other hand, you
  165.    can use ASL file and font requesters via the Amiga menu item. You can
  166.    use AmigaDOS path syntax in some LISP commands too.
  167.    
  168.    The current patch-set supports the following baseline versions:
  169.    GNU-Emacs-19.34b, 20.2, 20.2.92, 20.2.97, 20.3.
  170.    
  171.    
  172.    SYSTEM REQUIREMENTS
  173.    
  174.    For using intuition: graphics.library-39 or better is required. (part
  175.    of AmigaOS V39)
  176.    
  177.    General: A lot of RAM or virtual memory. A fast CPU is recommended. I
  178.    have only an 68030-40MHz which is sometimes too slow even for parts of
  179.    some standard ELISP packages.
  180.    
  181.    Note: Different ELISP packages may have very different RAM-/CPU-usage.
  182.    
  183.    LIBRARIES
  184.    
  185.    ixemul.library - the free UNIX kernel emulation + standard C library
  186.    (incl. socket interface)
  187.    
  188.    If you want to configure and build Emacs for running on X window
  189.    system, you will need the required X libraries and headers. A free
  190.    X11R6 package is part of ADE/GG. There are other X window ports, but I
  191.    have tested only ADE-X.
  192.    
  193.    NO PROBLEMS
  194.    
  195.    I used Emacs (20.2) mainly as programming environment, to write HTML
  196.    and as editor for an external News+Mail-reader.
  197.    
  198.    I have used the following packages very often:
  199.    
  200.    c/c++-mode (indenting slow since 20.2) * font-lock/fast-lock (in 20.2
  201.    sometimes you have to restart it because of a not complete fixed bug)
  202.    * ETags * sh-mode * Info * Ediff * GUD (for programs using signal
  203.    handlers (like Emacs itself) it's better to use gdb on console because
  204.    there are no process-groups and Emacs handle/blocks some signals). *
  205.    Emacs-Server * HTML-mode * ELISP modes and tools like debuggers and
  206.    profilers. * Occur, IMenu, HS
  207.    
  208.    I have tested, but don't use the following packages:
  209.    
  210.    AucTeX (seems to work OK but I don't need it currently) * GNus (works,
  211.    but is very slow on my machine) * W3 (works, but is very slow) *
  212.    Ange-FTP (needs PTYs, you have to install+run Devs:fifo.handler).
  213.    
  214.    BUILT-IN WORKAROUNDS
  215.    
  216.    HOME variable is translated from AmigaOS to UNIX syntax at startup of
  217.    Emacs, EmacsServer, EmacsClient. That means all subprocesses inherit
  218.    the UNIX syntax version. (prevents problems by using $HOME as kind of
  219.    ID on sockets).
  220.    
  221.    The home directory read from password files will be translated to UNIX
  222.    syntax.
  223.    
  224.    A built-in default TERMCAP entry for TERM=amiga exists.
  225.    
  226.    Note: Internally Emacs uses UNIX-path syntax (to gain maximal
  227.    compatibility with ELISP packages written for UNIX). I changed a few
  228.    user-interface functions to accept both UNIX- and AmigaOS syntax. This
  229.    works very well.
  230.    
  231.    The Intuition code inside of Emacs implements serveral X functions
  232.    (limited to the needs of Emacs). It even fakes the `window-system'
  233.    variable to X. Therefore, any ELisp package written for X should work
  234.    without any changes. To check for running on Intuition, you have to
  235.    test for (boundp 'amiga-i-windows).
  236.    
  237.    Console: Because `^C' is always handled by console (SIGBREAK_C) there
  238.    is a key-translation from C-z to C-c (located in
  239.    "lisp/term/amiga.el").
  240.    
  241.    FEATURES
  242.    
  243.    AmigaOS specific: Bidirectional AREXX port as interface to ELISP
  244.    language * Two different file-system path syntaxes.
  245.    
  246.    Intuition-GUI: multiple colors and font styles * multiple frames
  247.    (Intuition windows) on one or more public screens (and invisible
  248.    frames too) * vertical scroll bars * pens are not really obtained from
  249.    system until first use in drawing. * Workbench iconify and drag'n'drop
  250.    * clipboard support * pop-up menu (configurable, scroll-able, full
  251.    keyboard control) * ASL file+font requester (used by "Amiga" menu) *
  252.    provides most of old "amiga-" LISP-functions for compatibility with
  253.    formerly Emacs-18 AmigaOS port (e.g. amiga-set-geometry) * 2 different
  254.    modes for numeric keypad (NumLock) * provides Meta, Super and Hyper
  255.    modifier keys
  256.    
  257.    console: amiga-set-font implements font changing on CON:
  258.    
  259.    TTY: you can open a sub shell if your shell implements no job-control.
  260.    
  261.    MULE on Emacs-20: I merged in relevant parts of MBSK to allow
  262.    switching it (MBSK) on/off on different window systems. To enable MBSK
  263.    it's needed to pass the parameter "no-mule" to "lisp/loadup.el" at
  264.    dump-time. The Makefile do handle this automatically (using the
  265.    variable LOADUP_ARRGS): MBSK is per default enabled for Intuition-GUI,
  266.    but disabled for X.
  267.    
  268.    Example: To always disable MBSK compile with
  269.    $ make "LOADUP_ARGS=" ...
  270.    To always enable it use
  271.    $ make "LOADUP_ARGS=no-mule" ...
  272.    
  273.    BUGS
  274.    
  275.    Intuition: Italic font style is broken (it's nearly unusable for
  276.    editing) * Currently no gad-tools menu (we use the pop up menu by the
  277.    menu-bar too) * No 16 bit fonts. Use ADE-X to have a full working
  278.    MULE. * No working multi keyboard * Never tried a 2 button mouse, but
  279.    I guess there are ELISP-packages handling that problem already
  280.    
  281.    MultiUser: I have running MultiUser (mufs) on my system. This causes
  282.    the root directory of volume in RAM: having access bits
  283.    "700","drwx------". You cannot create files and call DirEd in that
  284.    directory. But you can/should change at least the access bits of
  285.    sub-directories in RAM: like this:
  286.    $ chmod 777 /ram/T /ram/ENV /ram/ClipBoards.
  287.    
  288.    TeX: IxEmul has a problem to pass `\' as part of arguments to all
  289.    non-ixemul binaries. This is a problem when using the TeX program from
  290.    PasTeX on Meeting-Pearls-CDROM. There is a workaround in directory
  291.    `amigaos/' using the small non-ixemul command-shell from
  292.    Emacs-18.59-amigaos. Another problem: killing a non-ixemul TeX binary
  293.    may crash the system. A ixemul port of TeX may work better. Such one
  294.    is part of ADE/GG.
  295.    
  296.    Soft-Links: The clash detection uses soft-links since Emacs-20.2. I
  297.    have no problems with this so far. In general, for editing files
  298.    visited over a soft-link you may need to use:
  299.    (setq find-file-visit-truename t)
  300.    in your ~/.emacs file. This may not required if you use the latest
  301.    BETA-ffs (http://www.amiga.de). Unluckily, as it seems, there is no
  302.    MuliUser patch for that FFS.
  303.    
  304.    HISTORY
  305.      * August '98: Emacs-20.3
  306.      * June '98: Emacs-19.34b updated. New distribution format (common
  307.        amiga specific files in base distributions and patches in updates;
  308.        bug-fix-patches in base-distributions; version patches for
  309.        baseline files in base distributions and updates)
  310.      * May '98: X window tested (ADE-X11R6.3 running on A1200-030/40)
  311.      * March '98: Clipboard and AREXX
  312.      * January '98: Emacs-20.2
  313.      * Winter '97: Emacs-19.34b
  314.      * Autumn '97: Emacs-19.29 (Intuition)
  315.      * Summer '97: Emacs-19.28 (Tty only)
  316. ===========================================================================
  317. '
  318.